
About
=====

This is the Clean Object I/O library version 1.1 for Windows95
and Windows NT. The Clean Object I/O is (c) 1998  University of Nijmegen,
Hilt B.V.

Install
=======

It is handy to put all Object I/O library folders into the Clean 1.3.2
folder. To use the object I/O library you have to set two paths within the 
CleanIDE's Options/Paths dialog. One to the "Object IO 1.1" folder and
one to the "OS Windows" subfolder of that folder. For example the default
paths part of the dialog could look like the following:

	{Application}\StdEnv
	{Application}\Object IO 1.1
	{Application}\Object IO 1.1\OS Windows

It is not necessary anymore to increase heap space for the CleanIDE or
to change the StdEnv path like in older versions. All libraries that work
with Clean 1.3.2 work with the same StdEnv.

Use the Object I/O library version 1.1 with the CleanIDE/compiler
version 1.3.2 or higher, but not with versions less than 1.3.2.

A tutorial for this library is available from the Clean homepage at:

  http://www.cs.kun.nl/~clean/

Differences between the Object I/O library versions 1.0.1 and 1.1
=================================================================

Version 1.1 is not upward compatible to version 1.0.1.

It follows a list of changes per module by order of importance:

StdPrint, StdPrintText
	new printing facilities

StdFont, StdFontDef
	As a consequence of adding printing the FontEnv class has been removed. The font
	functions that were applicable both to the World and the PSt are now only
	applicable to Pictures. The StdFontDef module and the StdFont modules have
	been removed, and the font handling functions can be found in StdPicture now.
	The StdPSt module's function accScreenPicture can be helpful to
	port older programs to the new library version. Let's assume that an old
	program contained the following:
	
	   Start world
	   	= openFont SerifFontDef world
	
	To port this to version 1.1 this can be replaced by the following:
	
	   Start world
	   	= accScreenPicture (openFont SerifFontDef) world

StdPicture
	- Font handling functions which were in the module StdFont before were added
	- No function gets non unique Picture arguments anymore. The following functions
	  were therefore removed: getPicture, getPictureAttributes, setPictureAttributes.
	  The following functions now get a unique Picture argument and also deliver a
	  unique Picture: getPenPos, getPenSize, getPenColour, getPenFont
	- draw(seq)Picture and xor(seq)Picture were replaced by appPicture and appXorPicture
	- There is no Clips class anymore. Instead a new type Region is introduced with the
	  functions appClipPicture and accClipPicture.
	- The Drawables and Fillables classes have been extended with undraw/unfill
	  functions.
	- new functions: accPicture, accXorPicture, getResolution

StdReceiver
	- the function reopenReceiver of the Receivers class has been removed.
	- openReceiver now takes a _unique_ receiver definition as argument.
	- instance == SendReport added
	
StdIOCommon
	- the module has been split into two modules: StdIOCommonn and StdIOBasic

StdTime
	- The new type Tick which resembles the current time measured in
	  (platform dependent) ticks has been added. The TimeEnv class is is extended with
	  the function getCurrentTick.
 
StdPSt
	- The IOSt and PSt are instances of the FileEnv, TimeEnv and Ids classes.
	- new functions: app(acc)ScreenPicture (see above)

StdReceiverDef
	- new ReceiverAttribute: ReceiverConnectedReceivers	

StdSystem
	- new: newlineChars, printSetupTypical

Feedback
========

Please report bugs, suggestions and comments to
    mailto:clean@cs.kun.nl
